Skip to content

Augment add-command-spec skill#206

Merged
lucieleblanc merged 5 commits into
mainfrom
lucie/improve-command-spec-skill-1
Mar 31, 2026
Merged

Augment add-command-spec skill#206
lucieleblanc merged 5 commits into
mainfrom
lucie/improve-command-spec-skill-1

Conversation

@lucieleblanc
Copy link
Copy Markdown
Contributor

This PR adds instructions for the research, validation and submission steps in adding a completion spec. This is meant to be a V1 to test in Linear automations.

Copy link
Copy Markdown

@vkodithala vkodithala left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM! Really excited to get the ball rolling here!

Comment on lines +24 to +28
1. Install Fish if needed (`brew install fish` on UNIX)
2. Run: `fish -c 'complete -C "<command> "'` to see top-level completions
3. Drill into subcommands: `fish -c 'complete -C "<command> <subcommand> "'`

For example, to inspect `gcloud compute ssh` completions: `fish -c 'complete -C "gcloud compute ssh w"'` (where `w` is the start of a known target).
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nice!


### Start with Fish shell completions

Fish maintains high-quality, community-reviewed completion definitions at https://github.com/fish-shell/fish-shell/tree/master/share/completions — look for `<command>.fish`. These are thorough and well-structured, so they're the fastest way to get a comprehensive picture of a command's subcommands and flags. Read this file first.
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

More out of curiosity, but do we want the agent to use the WebSearch tool to retrieve this file? If so, maybe it makes sense to directly say this, like "use the WebSearch tool..."

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm not sure we need websearch for this; I think the agent can download the source code directly using wget


## Step 2: Implement the Spec

1. **Create the JSON spec**: `command-signatures/json/<command>.json` following the [Fig completion spec schema](https://fig.io/docs/reference)
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm getting a 503 from this link.

Image

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you! Removed

@lucieleblanc lucieleblanc enabled auto-merge (squash) March 31, 2026 22:24
@lucieleblanc lucieleblanc merged commit 703ddea into main Mar 31, 2026
3 checks passed
@lucieleblanc lucieleblanc deleted the lucie/improve-command-spec-skill-1 branch March 31, 2026 22:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants